package com.chaoxi.picturebackend.service;

import com.baomidou.mybatisplus.core.conditions.query.QueryWrapper;
import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
import com.chaoxi.picturebackend.model.dto.space.SpaceAddRequest;
import com.chaoxi.picturebackend.model.dto.space.SpaceQueryRequest;
import com.chaoxi.picturebackend.model.entity.Space;
import com.baomidou.mybatisplus.extension.service.IService;
import com.chaoxi.picturebackend.model.entity.User;
import com.chaoxi.picturebackend.model.vo.space.SpaceVO;

import javax.servlet.http.HttpServletRequest;

/**
* @author 朱杰
* @description 针对表【space(空间)】的数据库操作Service
* @createDate 2025-10-13 09:58:05
*/
public interface SpaceService extends IService<Space> {

    /**
     * 创建空间
     * @param spaceAddRequest 创建空间请求
     * @param loginUser 登录用户
     * @return 创建的空间ID
     */
    long addSpace(SpaceAddRequest spaceAddRequest, User loginUser);

    /**
     * 校验空间参数
     * @param space 空间实体对象
     * @param add 是否为添加操作
     */
    void validSpace(Space space, boolean add);

    /**
     * 获取查询条件
     *
     * @param spaceQueryRequest 查询条件请求
     * @return 查询条件构造器
     */
    QueryWrapper<Space> getQueryWrapper(SpaceQueryRequest spaceQueryRequest);
    
    /**
     * 将Space对象转换为SpaceVO对象
     * @param space 空间实体对象
     * @param request HTTP请求对象，用于获取请求上下文信息
     * @return 转换后的SpaceVO对象
     */
    SpaceVO getSpaceVO(Space space, HttpServletRequest request);

    /**
     * 将Page<Space>分页对象转换为Page<SpaceVO>分页对象
     * @param spacePage 空间实体分页对象
     * @param request HTTP请求对象，用于获取请求上下文信息
     * @return 转换后的SpaceVO分页对象
     */
    Page<SpaceVO> getSpaceVOPage(Page<Space> spacePage, HttpServletRequest request);

    /**
     * 根据空间级别填充空间信息
     * @param space 空间实体对象
     */
    void fillSpaceBySpaceLevel(Space space);

    /**
     * 检查空间权限
     * @param loginUser 登录用户
     */
    void checkSpaceAuth(User loginUser, Space space);
}